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About This Guide 


This guide describes how to use the Novell® Client™ for Linux features available in the Novell 
Client tray application. This guide is intended for users and contains the following sections: 


+ Chapter 1, “Using the Novell Client Tray Application,” on page 9 
+ Chapter 2, “Using Novell Utilities,” on page 15 
Additional Documentation 


For documentation on installing and administering Novell Client for Linux, see the Novell Client 
1.0 for Linux Installation and Administration Guide. 


For documentation on known issues, see the Novell Client for Linux Readme. 


For documentation on login scripts, see the Novell Login Scripts Guide. 


Documentation Updates 


For the latest version of this documentation, see the Novell Client online documentation (http:// 
www.novell.com/documentation/linux_client/index.html). 


Documentation Conventions 


In this documentation, a greater-than symbol (>) is used to separate actions within a step and items 
within a cross-reference path. 


A trademark symbol e, TM, etc.) denotes a Novell trademark. An asterisk (*) denotes a third-party 
trademark. 


When a single pathname can be written with a backslash for some platforms or a forward slash for 
other platforms, the pathname is presented with a backslash. Users of platforms that require a 
forward slash, such as Linux* or UNIX*, should use forward slashes as required by your software. 


User Comments 


We want to hear your comments and suggestions about this manual and the other documentation 
included with this product. Please use the User Comment feature at the bottom of each page of the 
online documentation, or go to www.novell.com/documentation/feedback (http:// 
www.novell.com/documentation/feedback) and enter your comments there. 
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Using the Novell Client Tray Application 


The Novell® Client™ for Linux workstation software extends the capabilities of Linux desktops 
by providing access to NetWare® and Open Enterprise Server (OES). When installed on 
workstations, the Client lets you enjoy the full range of Novell services such as authentication via 
Novell’s eDirectory™, network browsing and service resolution, and secure and reliable file 
system access. The Client supports Novell’s traditional NCP™ protocol. 


Novell Client for Linux supports workstations running either of the following: 
+ Novell Linux Desktop (NLD) 9 SP2 or later 
+ SUSE® Linux Professional 9.3 


For information on installing the Novell Client for Linux, see the Novell Client 1.0 for Linux 
Installation and Administration Guide. 


This section contains the following information: 
¢ Starting and Stopping the Novell Client Tray Application (page 9) 
+ Logging In to the Network (page 10) 
+ Logging Out of a Network Location (Server or Tree) (page 11) 
+ “Viewing Your Network Connections” on page 11 
+ Changing Your Network Password (page 12) 
+ Mapping Network Directories (page 12) 
+ Disconnecting a Mapped Directory (page 14) 
+ Changing the Location of the Novell Client Tray Application (page 14) 


+ Viewing Novell Client Version Information (page 14) 


Starting and Stopping the Novell Client Tray Application 


You can use the Novell Client tray application to access many of the Novell Client for Linux 
features. Simply click the red N icon (à) located either in the tray or in the floating window. The 
location of this icon is based on your workstation and your preferences and can be changed using 
the Novell Client Options menu. See “Changing the Location of the Novell Client Tray 
Application” on page 14 for more information. 


Click À to see the following menu: 
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Figure 1 The Novell Client Tray Application Menu 


IN] Novell Login 

N] Novell Logout 

Novell Connections 

À Change Password 

© Novell Map Directory 

Disconnect Novell Mapped Directory 
Novell Utilities > 
User Preferences 
System Settings 
Novell Client for Linux Documentation 
About 


O ouit Ctrl+Q 


If you want to stop the Novell Client tray application from appearing on the tray, click N> Quit. 


To restart the Novell Client tray application (or if for some reason the red N icon (à) does not 
appear in your tray or float window), use one of the following methods: 


+ NLD GNOME: Click Programs > Accessories > Novell Tray. 

+ SUSE 9.3 GNOME: Click Applications > Applications > Novell Tray. 

+ NLD and SUSE 9.3 KDE: Click the menu button > Applications > Novell Tray. 
¢ Enter the following command in a terminal window: 


/opt/novell/ncl/bin/ncl_tray 


Logging In to the Network 
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When you log in to the network, you gain access to directories and files as well as other services 
provided by network servers. Your network administrator should provide you with the required 
information so that you can log in. 


1 Use one of the following methods to open the Novell Login dialog box: 

+ Click Ù > Novell Login. 

+ NLD GNOME: Click Programs > Accessories > Novell Login. 

+ SUSE 9.3 GNOME: Click Applications > Applications > Novell Login. 

+ NLD and SUSE 9.3 KDE: Click the menu button > Applications > Novell Login 
2 Enter your username and password, then click Advanced. 
3 Specify the tree, context, and server information for the server you want to connect to. 


You can type a DNS name or an IP address for the server. See your network administrator for 
this information. 


If your network has SLP set up, you can browse a list of available trees, contexts, and servers 
by clicking their associated buttons. 


4 (Optional) To clear any existing connections to servers before logging in, select Clear current 
connections. 


5 (Optional) To run login scripts during this login session, click the Script tab, then select the 
options needed to run the login scripts. 


Novell Client 1.0 for Linux User Guide 


For more information on login scripts, see “Running Novell Login Scripts during Login” on 
page 11. 


6 Click OK to log in to the server specified in Step 3. 


Running Novell Login Scripts during Login 


When you successfully log in to the network, one or more login scripts are executed. Login scripts 
can be used to automatically map drives and search drives to directories, display messages, set 
environment variables, and execute programs or menus. 


You can specify whether login scripts are run, whether the results are displayed, and whether the 
login window is automatically closed during login. In addition, if the login script uses the %2, %3, 
%4, or %5 variable, you can set these variables by clicking the Variables button. 


Your network administrator should provide information on whether to use login scripts and, if so, 
which login scripts to use. 


For additional information on setting up login scripts, see the Novell Login Scripts Guide. 


Logging Out of a Network Location (Server or Tree) 


You can log out of a network location in either of the following ways: 
+ To log out of all existing connections, click > Novell Logout > Logout. 


+ If you are logged in to multiple trees and want to log out of a specific server or tree, click N 
> Novell Connections, select the tree or server that you want to log out of, then click Detach. 


Viewing Your Network Connections 


Novell Connections allows you to see what servers and trees you are logged in to. You can refresh 
connections, set a specific tree as your primary connection, or log out of a tree or server. 


4 Click È > Novell Connections. 
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Novell Connections 


N Loh 2231 You are attached to the following: 


Available Connections: 


Resource User ectory Tree ConnNo. Authentication State Trans Type 
“. NOVELL INC * etobiasson.D l l | = = 
IPRV-PROD81 § CN=ETOBIASSON  NOVELL_INC 21 eDirectory 

PRV-PROD93 § CN=ETOBIASSON  NOVELL_INC 9 eDirectory 


2 Do any of the following: 


+ Toseta connection as the primary connection: Select the server you want to set as the 
primary connection, then click Set As Primary. 


+ To refresh a connection: Select the connection that you want to refresh, then click 
Refresh. 


+ To disconnect from a connection: Select the connection you want to detach from, then 
click Detach. 


3 Click Close. 


Changing Your Network Password 


To change your eDirectory password: 
4 Click D > Change Password. 
2 Type your current password in the Old Password field. 
3 Type your new password in the New Password field. 
4 Retype the new password in the Confirm Password field. 
5 Click OK. 


Mapping Network Directories 


When you map a directory, you create a symbolic link or shortcut to a path on the network and 
assign it a name and location on your workstation. After the drive is mapped, you can use the 
symbolic link to access the network resource, if you have sufficient rights on that resource. You 
can map to a specific folder on the resource or to the root of the resource. 
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1 Click & > Novell Map Directory. 


Novell Map Directory 


Select the Novell directory you 
Novell want to map to and assign it a name 
and location on your workstation. 


Workstation File System 


Enter the location where the link will reside: 


Enter the name of the link or select a drive letter: 
+ 


r Novell File System 
Enter the server name and path to the directory 
you want to map to: 


2 Specify the path on the local file system where the symbolic link to the network resource is to 
be created (using forward slashes). 


For example: /home/bsmith 


You can also click the Browse button and select the location on the local file system where 
the symbolic link is to be created. 


If no location is specified, the symbolic link is created in the Map Link Default Location 
configured in the System Settings or in your home directory. 


3 Type the name of the symbolic link to be created, or select a letter from the drop-down list (if 
you want to use a single letter as the name for the link). 


4 In the Novell File System field, type the server name and the path to the directory you want 
to map. 


The path can be in any of the following forms: 
+ //server/volumelpath 

+ — server/volume: 

+ — server/volume:/path 


+ directory object name.fully distiguished eDirectory path (such as a cluster volume, 
for example: my_dir.usrs.accnt.mycompany) 


You can also click the Browse button and locate the directory you want to map. 


5 Click Map. 


The mapped drive appears in your home directory (by default) or in the directory you specified in 
Step 2. 


Disconnecting a Mapped Directory 


4 Click È > Disconnect Novell Mapped Directory. 
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2 Select the mapped directory that you want to disconnect from, then click Disconnect. 


Changing the Location of the Novell Client Tray Application 


Use the User Preferences dialog box to change the location of the Novell Client tray application. 
This is useful if your workstation has problems with tray icon support. If you are unable to see the 
tray icon under the Windows Manager, you can select the Use Float Window option to create a 
floating icon ( N ) that can be used to access the Novell Client tray application features. 


4 Click Ù > User Preferences. 
2 Select the location you want for the Novell Client tray application. 


3 Click OK. 


Configuring the Novell Client 


To configure the Novell Client, run the Novell Client Configuration Wizard. It lets you configure 
file browser, protocol, login, tray application, and OpenSLP settings. 


4 Click È > System Settings. 

2 Ifyou are not logged in as root, type the root password, then click OK. 

3 Select the Client settings you want to configure, then click Start Wizard. 

4 Follow the instructions in the left panel to configure the Novell Client settings. 
5 When you are finished, click Finish. 


6 (Conditional) If you made changes to the Protocol Settings page or the Service Location 
Protocol (OpenSLP) Settings page, reboot the machine for those changes to take effect. 


For more information, see “Using the Novell Client Configuration Wizard” in the Novell Client 


for Linux Installation and Administration Guide. 
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To obtain version information for the Novell Client in the Novell Client tray application, click 
About. This window also contains information on the specific packages loaded, including their 
status, version, and release information. 


You can also link to the Novell Client for Linux product page (http://www.novell.com/products/ 
clients/linux/overview.html) from the About dialog box. 


4 Click È > About. 


2 Click the Packages tab to view information on the Novell Client for Linux packages loaded, 
including status, version, and release information. 


3 Click the Kernel tab to view information on the kernel and novfs. 


4 Click OK. 
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Using Novell Utilities 


You can access various Novell® utilities by selecting the Novell Utilities option on the Novell 
Client!" tray application menu. The options on the submenu let you do the following: 


¢ Assigning Rights to Volumes, Files, and Directories (page 15) 
+ Setting Inherited Rights and Filters (page 17) 

+ Viewing Object Properties (page 18) 

+ Salvaging Deleted Files (page 20) 

+ Purging Deleted Files (page 21) 

+ Sending Messages to Users (page 22) 

+ Sending Messages to the System Console (page 22) 


Assigning Rights to Volumes, Files, and Directories 


The Trustee Rights utility lets you display and give rights to volumes, files, and directories on a 
Novell server. A trustee is an object (such as a User object, Group object, Organizational Role 
objects, or container object) that has (or will have) rights to a volume, directory, or file. Trustee 
assignments allow you to assign ownership, set permissions, and monitor user access. You must 
have the Access Control (http://www.novell.com/documentation/nw65/nss_enu/data/ 
bri5796.html#bs3fjo7) right to change trustee assignments. 


4 Click È > Novell Utilities > Trustee Rights. 


2 Select the folder or file you want to set trustee rights for, then click OK. 
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Novell Services 


| Novell Rights | 


Trustees SRWECMFA 


ETobiasson.DOCDEV.PRV.Novell MMM) 


PHattangadi.ENG.BLR.INDIA.Novell FERMEN 


Remove | 


m Effective Rights 


t 


Epes 7 
-> EPM 
+-2§ ESD 
+28 FACILITIES 
ae) 
Inherited Rights and filters... | Add 


( Ok } Cancel | 


3 To add a trustee, select the object in the tree diagram, click Add, then set the rights for this 
user by selecting the boxes under the letters on the right. 


For each trustee in the list, there is a set of eight check boxes, one for each right that can be 
assigned. Ifa check box is checked, the trustee has that right. To assign or unassign rights, use 
the check boxes in the dialog box. 


The following rights can be set for each trustee: 


+ 


Read: For a directory, grants the right to open files in the directory and read the contents 
or run the programs. For a file, grants the right to open and read the file. 


Write: For a directory, grants the right to open and change the contents of files in the 
directory. For a file, grants the right to open and write to the file. 


Erase: Grants the right to delete the directory or file. 


Create: For a directory, grants the right to create new files and directories in the 
directory. For a file, grants the right to create a file and to salvage a file after it has been 
deleted. 


Modify: Grants the right to change the attributes or name of the directory or file, but does 
not grant the right to change its contents (changing the contents requires the Write right). 


File Scan: Grants the right to view directory and file names in the file system structure, 
including the directory structure from that file to the root directory. 


Access Control: Grants the right to add and remove trustees for directories and files and 
modify their trustee assignments and Inherited Rights Filters. 


Supervisor: Grants all rights to the directory or file and any subordinate items. The 
Supervisor right can’t be blocked by an Inherited Rights Filter. Users with this right can 
grant or deny other users rights to the directory or file. 


4 To remove a trustee, select one or more trustees in the Trustees list, then click Remove. 


5 To view a list of rights and filters inherited by this volume, click Inherited Rights and Filters. 
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6 To apply the same trustee assignments to a group of selected files, click Combine Multiple 


Trustees. 


This check box is available only if you’re viewing the right for multiple files or directories. 

At least one of the files or directories must have at least one trustee assignment. The trustees 
and rights shown are the combined trustees and rights for all of the files. If you check Combine 
Multiple Trustees, the trustee assignments that are chosen apply to all of the selected files after 


you click OK or Apply. 


7 Click Apply, then click OK when you are finished modifying trustee rights. 


Setting Inherited Rights and Filters 


The Inherited Rights and Filters utility lets you view and set information about trustees and rights. 
Rights assignments on eDirectory™ containers can be inheritable or non-inheritable, but all rights 
assignments on directories are inheritable. You can block such inheritance on individual 
subordinate items so that the rights aren’t effective on those items, no matter who the trustee is. 
One exception is that the Supervisor right can’t be blocked. 


4 Click À > Novell Utilities > Inherited Rights and Filters. 


2 Select the folder or file you want to view or set inherited rights and filters for, then click OK. 


Trustees Inherited from Selected Item and Parent Directories: 


Inherited Rights and Filters 


Novell. Right-click a trustee to view effective rights and properties. 


SRWECMFA 


Scott_Group.DOCDEV.PRV.Novell - [DOC:] 
ETobiasson.DOCDEV.PRV.Novell - [DOC:] 
PHattangadi.ENG.BLR.INDIA.Novell - [DOC:edir873\] 
ETobiasson.DOCDEV.PRV.Novell - [DOC:edir873\] 


View Trustees Below Directory 


m Uncheck to filter rights inherited from parent directories 


BRENT 
EMMEN 
EFFFRFPFRT 
Haddad 


BI IR) Read 2R) Erase 8]! Modify 
#1) Write # IX) Create B X) File Scan 


# IX) Access Control 
B (R) Supervisor 


Clear All 


Cancel 


The main part of this dialog box is the list of trustees inherited from the selected item and its 


parent folders. 


3 To assign or unassign rights, use the check boxes to the right of a trustee. 


For each trustee in the list, there is a set of eight check boxes, one for each right that can be 
inherited. If a check box is selected, the trustee has that right. 


The following rights can be set for each trustee: 


+ 


Read: For a directory, grants the right to open files in the directory and read the contents 


or run the programs. For a file, grants the right to open and read the file. 


Write: For a directory, grants the right to open and change the contents of files in the 


directory. For a file, grants the right to open and write to the file. 
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+ Erase: Grants the right to delete the directory or file. 


+ Create: For a directory, grants the right to create new files and directories in the 
directory. For a file, grants the right to create a file and to salvage a file after it has been 
deleted. 


+ Modify: Grants the right to change the attributes or name of the directory or file, but does 
not grant the right to change its contents (changing the contents requires the Write right). 


+ File Scan: Grants the right to view directory and file names in the file system structure, 
including the directory structure from that file to the root directory. 


+ Access Control: Grants the right to add and remove trustees for directories and files and 
modify their trustee assignments and Inherited Rights Filters. 


+ Supervisor: Grants all rights to the directory or file and any subordinate items. The 
Supervisor right can’t be blocked by an Inherited Rights Filter. Users with this right can 
grant or deny other users rights to the directory or file. 


4 To see a list of trustees for subfolders of the currently selected folder, click View Trustees 
Below Directory. 


A list of all the users and their rights to each subfolder appears. You can modify or remove 
rights from this list. 


5 To view a trustee’s current effective rights (taking into account the Inheritance filter), right- 
click a trustee name, then click Current Effective Rights. 


Users can receive rights in a number of ways, such as explicit trustee assignments, inheritance, 
and security equivalence. Rights can also be limited by Inherited Rights Filters and changed 
or revoked by lower trustee assignments. The net result of all these actions (the rights a user 
can employ) are called effective rights. 


6 To view a trustee’s properties (such as if they have the rights to modify inherited rights at this 
level), right-click a trustee name, then click Properties. 


7 Click Apply, then click OK when you are finished modifying inherited rights and filters. 


Viewing Object Properties 
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The Object Properties utility lets you view the property pages (Folder Information and Novell 
Rights) for a selected object. The property pages let you see information and statistics about that 
object. If you have sufficient rights, you can set attributes for that object. 


4 Click © > Novell Utilities > Object Properties. 
2 Select the object you want to see the properties for, then click OK. 


3 On the Folder Information page, you can view the owner of the folder, the name spaces 
enabled on the folder, the amount of disk space available to you, the date the folder was 
created, updated, and archived, and any attributes set on the folder. 
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PUBLIC Properties 


| Folder Information | Novell Rights | 
Nove IL Information about selected directory 


Selected Directory: PUBLIC 


Owner: CN=etobiasson1.O=novell 
Name Space: LONG 


Space Restriction: 64.0 KB (64 KB) 


3 Change 
Space Available: 6.3 GB (6 644 696 KB) 


Created: 03 August 2005 11:44:38 
Update: 03 August 2005 11:44:38 
Archived: Never Archived 


| Archive 

| Hidden 

| Rename Inhibit 
| Delete Inhibit 


Attributes: | Read-only 

| Don't Compress 

| Immediate Compression 
| Purge Immediate 


( Ok ) Cancel 


4 Ifyou have rights to modify this object and need to make changes, select the properties you 
want to changed. 


5 To view the eDirectory rights associated with this object, click the Novell Rights tab. 


PUBLIC Properties 


| Folder Information Novell Rights | 


Trustees SRWECMFA 
[Public] COTTA 


D 


+-@ eDirectory 


Inherited Rights and filters 


Effective Rights 
Read Erase Modify Access Control 
Write Create File Scan Supervisor 


Ok ) Cancel | | 


If you have Access Control rights and need to make changes to the Novell rights associated 
with this object, see “Managing File Security” in the Novell Client 1.0 for Linux Installation 
and Administration Guide for specific steps on setting Novell file rights. 


If you do not have Access Control rights, your effective rights to the file appear in the 
Effective Rights box. You cannot change these rights. 
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6 Click Apply, then click OK when you are finished viewing or modifying the object’s 
properties. 


Salvaging Deleted Files 


The Salvage utility lets you recover deleted files and directories from Novell file systems. Files 
that have been purged cannot be recovered. 


IMPORTANT: You cannot salvage files or directories from an OES for Linux Reiser volume. 
4 Click È > Novell Utilities > Salvage Deleted Files. 


2 Select the folder where the files you want to recover are located, then click OK. 


Salvage Novell Directory Files 


Directory: HOME:\Etobiasson\sharing 


Salvageable Files: Status: Found 0 items 


Filename Date Deleted Time Deleted FileSize | User Name Last Update Date Last Update Time | Last Updater t 


ea mn) 


IX] Do not show 0 size files. 


3 Select the files you want to recover. 


To display files with 0 bytes, deselect Do Not Show 0 Size Files (selected by default). This 
refreshes the display to show all deleted files, no matter the size. 


4 Click Salvage File. 
To salvage all deleted files in the folder, click Salvage All. 


5 Click Close. 


Purging Deleted Files 


The Purge utility lets you purge deleted files and directories from Novell file systems. Deleted files 
are purged from a volume when one of the following events occurs: 


+ The Purge Delay setting times out. Deleted files are purged automatically. 
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+ The server starts purging files if a volume starts to fill up; the oldest files that have been 
deleted are automatically purged. 


¢ Ifyou do not want a file to be restored after deletion, you can enable the Immediate Purge of 
Deleted Files parameter. The file is deleted and purged immediately. 
+ You manually purge the deleted files. 


WARNING: The Purge utility permanently removes deleted files from the selected directory. Purged files 
cannot be recovered with the Salvage utility. 


IMPORTANT: You cannot purge deleted files or directories from an OES for Linux Reiser volume. 
4 Click È > Novell Utilities > Purge Deleted Files. 
2 Select the folder where the files you want to purge are located, then click OK. 


Purge Novell Directory Files 


Novell. 


Directory: HOME:\Etobiasson\sharing 


Purgeable Files: Status: Found 0 items 


Filename Date Deleted Time Deleted File Size | User Name Last Update Date Last Update Time | Last Updater t 


4 l 


IR] Do not show 0 size files. 


| ) Purge Subdirectories 


3 Select the files you want to purge 


To display files with 0 bytes, deselect Do Not Show 0 Size Files (selected by default). This 
refreshes the display to show all deleted files, no matter the size. 


4 Click Purge File. 


To purge all deleted files in the folder, click Purge AIL To purge subdirectories, click Purge 
Subdirectories. 


5 Click Close. 


Sending Messages to Users 
Use the Send Message to User utility to send a simple message to users on the network. You can 


send the message to a single user or group or to multiple users or multiple groups of users. The 
message appears on the receiver’s screen in a Message Popup dialog box. On your screen, the Send 
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Message Results dialog box shows the results. Only users who are logged in at the time you send 
the message receive the message. 


IMPORTANT: This feature is not fully functional. You can send messages from a Linux workstation, but they 
can only be received by Windows* workstations. 


4 Click 2 > Novell Utilities > Send Message to User. 


2 Select a server to see a list of users and groups on that server, then click Select. 


Send Message to Users or Groups 


Send message to the selected 
N ove | l. users or groups. 


ETOBIASSON1/CN=ADMIN 


Enter message text: 


Select the users or groups who should receive this message: 


User Name Conn No. 
& admin.novell 

& admin.novell 

&* admin.novell 

& etobiasson1 .novell 

& etobiasson1.novell 

& etobiasson1.novell 

& etobiasson1.novell 


C] Show only user objects in list 


f Send ) 


3 Type the message you want to send in the Enter Message Text field. 
4 Select the users or groups that you want to receive the message. 
5 Click Send. 
The Send Message Results dialog box shows which users or groups the message was sent to. 


6 Click OK, then click Close. 


Sending Messages to the System Console 
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Use the Send Message to System Console utility to send messages to a server system console. 
IMPORTANT: This feature is not fully functional in this release. 
4 Click È > Novell Utilities > Send Message to System Console. 


2 Select a server, then click Select. 


Send Message to System Console 


N ove Il Send message to the server 


system console. 


ETOBIASSON1/CN=ADMIN 


Enter message text: 
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3 Type the message you want to send in the Enter Message Text field. 
4 Click Send, then click OK. 
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